.. _`Time Synchronisation`:

.. _`com.sympathyfordata.timeseriesanalysis.timeseries_synchronisation`:

Time Synchronisation
````````````````````

.. image:: time_sync.svg
   :width: 48


Synchronize two tables in time by matching features of selected signals.




Documentation
:::::::::::::

Synchronizes two tables in time by selecting a signal in each table and
then finding the time offset at which the features of those two signals
overlap the most.
The node uses cross-correlation internally to find the offset, hence the
signal features needs to be similar in shape, but scale doesn't matter.

Note that the resulting time offset will always be a multiple of the
smallest time step of the two signals.


Definition
::::::::::


Input ports
...........

    **Target table**  table
        Input table with target signal and time

    **Reference table**  table
        Input table with reference signal and time


Output ports
............

    **Result table**  table
        Target table from input with synchronized time column




Configuration
.............

    **Reference Signal** (reference_signal)
        Choose a column to use as the reference signal
    **Reference Time** (reference_time)
        Choose a column to use as the reference time
    **Target Signal** (target_signal)
        Choose a column to use as the target signal
    **Target Time column** (target_time)
        Choose a column to use as the target time







Examples
........

* :download:`timeseries_synchronisation.syx </Examples/Time Series/timeseries_synchronisation.syx>`




Implementation
..............

.. automodule:: node_sync_time
    :noindex:

.. class:: SynchronizeTimeseries
    :noindex: